home *** CD-ROM | disk | FTP | other *** search
/ STraTOS 1997 April & May / STraTOS 1 - 1997 April & May.iso / CD01 / GNU_KIT / DISK6.ZIP / gnu / man / cat1 / join.1 < prev    next >
Encoding:
Text File  |  1994-01-19  |  3.6 KB  |  67 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. JOIN(1L) JOIN(1L)
  8. NAME
  9.      join - join lines of two files on a common field
  10. SYNOPSIS
  11.      join [-a 1|2] [-v 1|2] [-e empty-string] [-o field-list...]
  12.      [-t char] [-j[1|2] field] [-1 field] [-2 field] file1 file2
  13. DESCRIPTION
  14.      This manual page documents the GNU version of join.  join
  15.      prints to the standard output a line for each pair of input
  16.                           _____     _____                           lines, one each from file1 and file2, that have identical
  17.      join fields.  Either filename (but not both) can be `-',
  18.                                   _____     _____                meaning the standard input.  file1 and file2 should be
  19.      already sorted in increasing order (not numerically) on the
  20.                               _                                      join fields; unless the -t option is given, they should be
  21.      sorted ignoring blanks at the start of the line, as sort
  22.                           _              does when given the -b option.
  23.      The defaults are: the join field is the first field in each
  24.      line; fields in the input are separated by one or more
  25.      blanks, with leading blanks on the line ignored; fields in
  26.      the output are separated by a space; each output line con-
  27.                                                         _____       sists of the join field, the remaining fields from file1,
  28.                                     _____       then the remaining fields from file2.
  29.      OPTIONS
  30.       _ ____ ______      -a file-number
  31.                                                         ____            Print a line for each unpairable line in file file-
  32.           ______                                                           number (either 1 or 2), in addition to the normal out-
  33.           put.
  34.       _ ______      -e string
  35.           Replace empty output fields (those that are missing in
  36.                           ______            the input) with string.
  37.       _   __ _____      -1, -j1 field
  38.                         _____                                           Join on field field (a positive integer) of file 1.
  39.       _   __ _____      -2, -j2 field
  40.                         _____                                           Join on field field (a positive integer) of file 2.
  41.       _ _____      -j field
  42.                          _ _____  _ _____            Equivalent to -1 field -2 field.
  43.       _ _____ ____         -o field-list...
  44.           Construct each output line according to the format in
  45.           _____ ____                  _____ ____                         field-list. Each element in field-list consists of a
  46.           file number (either 1 or 2), a period, and a field
  47.           number (a positive integer).  The elements in the list
  48.                                                        _____ ____           are separated by commas or blanks.  Multiple field-list
  49.                                                  _                       arguments can be given after a single -o option; the
  50. Page 1
  51. JOIN(1L) JOIN(1L)
  52.                                           _                            values of all lists given with -o are concatenated
  53.           together.
  54.       _ ____      -t char
  55.                         ____                                         Use character char as the input and output field
  56.           separator.
  57.       _ ____ ______      -v file-number
  58.                                                         ____            Print a line for each unpairable line in file file-
  59.           ______                                                          number (either 1 or 2), instead of the normal output.
  60. Page 2
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.